home *** CD-ROM | disk | FTP | other *** search
/ SGI Developer Toolbox 6.1 / SGI Developer Toolbox 6.1 - Disc 4.iso / src / demos / OpenGL / README < prev   
Encoding:
Text File  |  1994-08-02  |  8.4 KB  |  215 lines

  1.  
  2.                  ~4Dgifts/toolbox/src/demos/OpenGL README
  3.  
  4.  
  5.                 THIS CODE RUNS/COMPILES ON 5.1 Irix OR LATER
  6.                 THIS CODE WILL NOT RUN ON LESS THAN 5.1 Irix
  7.  
  8.     `!' indicates new or updated as of version 4.1
  9.  
  10.  
  11.  
  12.        this demos subtree contains OpenGL (some new/some old) demo source 
  13.        for atlantis, backtrace, drip, fadeflip, ideas, insect, lorenz, 
  14.        puzzle, space, stonehenge and tex_cube.
  15.  !             ^^^^^
  16.  
  17.         Two of the new demos use the OpenGL Motif Widget, libGLw.a (src 
  18.         is in toolbox/src/exampleCode/opengl/siggraphCD/lib/libGLw):
  19.  
  20.                backtrace
  21.                stonehenge
  22.  
  23.         Six use libtk, a library supplying simple windowing, event
  24.         handling, and more using only Xlib (src is in libtk, a symlink
  25.         to ../../exampleCode/opengl/siggraphCD/lib/libtk):
  26.  
  27.                atlantis
  28.                backtrace
  29.                insect
  30.                lorenz
  31.                puzzle
  32.                stonehenge
  33.  
  34.         Three (as well as all of the above) use only the GL and GLU 
  35.         OpenGL libraries:
  36.  
  37.                drip
  38.                fadeflip
  39.                ideas
  40.  
  41.  !      space simply uses the GL library.
  42.  
  43.  
  44.  
  45.     atlantis:  sharks, whales, and dolphins living side-by-side in harmony 
  46.         To Run:
  47.                 % atlantis [-dr] [-ir] [-f file.rgb]
  48.                 -dr           run in direct render mode (rendering goes 
  49.                               directly to the hardware)
  50.                 -ir           run in indirect render mode (rendering goes
  51.                               through the X server)
  52.                 -f file.rgb   by specifying a .rgb file, atlantis will use 
  53.                               the image to simulate the water reflection 
  54.                               off the fishes
  55.                 mouse buttons pressed while mouse held stationary:
  56.                 LEFTMOUSE   - translate "to the left and up"
  57.                 MIDDLEMOUSE - rotate "to the right and down"
  58.                 RIGHTMOUSE  - translate away from the eyepoint
  59.                 r/R KEY     - reset view as when window first came up
  60.                 ESC         - exit program
  61.         Demonstrates:
  62.                Lighting, animation capabilities, texture-mapping.
  63.  
  64.  
  65.  
  66.     backtrace:  demo of faked ray tracing
  67.         To Run:
  68.                 % backtrace
  69.                 RIGHTMOUSE  - rotates around the z axis
  70.                 MIDDLEMOUSE - changes radius
  71.                 LEFTMOUSE   - changes phi (azimuth)  
  72.                 ESC         - exit program
  73.                 To select a light, click (any MOUSEBUTTON) on it.  
  74.                 For a non-interactive demo, select "Rotate Automatically" 
  75.                 under the "Motion" menu.
  76.         Comments:
  77.                 Should run pretty quickly on most systems as long as the
  78.                 texture mapping is turned off.
  79.  
  80.  
  81.  
  82.     drip:  Makes little droplets of color.
  83.         To Run:
  84.                 % drip [-r[number]] [-f] [-w]
  85.                 every new MOUSEBUTTON press makes another expanding drop
  86.                 LEFTMOUSE   - make expanding red drops
  87.                 MIDDLEMOUSE - make expanding green drops
  88.                 RIGHTMOUSE  - make expanding blue drops
  89.                 ESC         - exit program
  90.                 -r          - makes random drops for a non-interactive demo.  
  91.                               Without the -r option, pressing LEFT/MIDDLE/RIGHT
  92.                               -MOUSE buttons makes drops of color.
  93.                 -f          - run in fullscreen mode
  94.                 -w          - set the background to WHITE
  95.         Demonstrates:
  96.                2D graphics
  97.                Blending functions.
  98.         Comments:
  99.                Not too involved or flashy, but should run quickly.
  100.  
  101.  
  102.  
  103.     fadeflip:  Flips a texture-mapped square around
  104.         To Run:
  105.                % fadeflip [file1.rgb] [file2.rgb] [file3.rgb] [...]
  106.                RIGHTMOUSE  - spin the object, 
  107.                              release while dragging to give momentum.
  108.                Without filenames, uses defaults.  Files must be square.  
  109.                If it complains it can't find the files, you may have 
  110.                to give it full pathnames.  
  111.         Demonstrates:
  112.                Texture mapping.
  113.         Comments:
  114.                Another small and mildly amusing demo
  115.  
  116.  
  117.  
  118.     ideas:  Ideas in Motion ported to OpenGL
  119.         To Run:
  120.                % ideas -a
  121.            LEFTMOUSE - restarts program animation sequence
  122.            SPACEBAR  - pause/unpause toggle
  123.                -a          run program continuously
  124.         Comments:
  125.                Should look good on almost any platform.
  126.         Demonstrates:
  127.                Stippling, lighting, animation capabilities.
  128.  
  129.  
  130.  
  131.     insect:  straight-ahead OpenGL port of thant-gaud's inspiration.
  132.  
  133.  
  134.  
  135.     lorenz:  ride on/near particles stuck in a Lorenz attractor
  136.         To Run:
  137.                 % lorenz [-h] [-i] [-x] [-s speed] [-w rot_v] [-g gravity]
  138.                 -h          Print this message.
  139.                 -i          Print information about the demo.
  140.                 -x          Enclose the particles in a box made of hexagons.
  141.                 -s speed    Sets the number of new line segments per redraw 
  142.                             interval per line. Default value: 3.
  143.                 -w rot_v    Spins the hexagons on their centers, and the sides
  144.                             of the box on their centers. Hexagons spin at the
  145.                             rate rot_v degrees per redraw, and box sides spin
  146.                             at -rot_v/2 degrees per redraw.
  147.                 -g gravity  Sets the strength of the attraction of the eye to
  148.                             the red particle. Actually, it's not gravity since
  149.                             the attraction is proportionate to distance.
  150.                             Default value: 0.002. Try large values!
  151.                 Executions control:  
  152.                     <spacebar>  step through single frames
  153.                     g           begin continuous frames
  154.                     s           stop continuous frames
  155.         Comments:
  156.                 shows particles stuck in a Lorenz attractor (parameters used 
  157.                 are r=28, b=8/3, sigma=10). The eye is attracted to the red 
  158.                 particle, with a force directly proportional to distance.  A 
  159.                 command line argument puts the particles inside a box made 
  160.                 of hexagons, helping  to maintain the sense of 3 dimensions, 
  161.                 but it can slow things down.  Other options allow you to play 
  162.                 with the redraw rate and gravity.
  163.  
  164.  
  165.  
  166.     puzzle:  move pieces in the proper order to solve the puzzle
  167.         To Run:
  168.                 % puzzle
  169.                 r   Reset puzzle
  170.                 s   Solve puzzle (may take a few seconds to compute)
  171.                 d   Destroy a piece - makes the puzzle easier
  172.                 b   Toggles the depth buffer on and off
  173.                 RIGHTMOUSE spins the puzzle
  174.                 LEFTMOUSE  moves pieces
  175.                 ESC        exit program
  176.  
  177.  
  178.  
  179.  !  space:      a simulation of the Solar System and the Milky Way galaxy.  
  180.                 when approaching vicinity of planets or moons actual 
  181.                 texture-map surfaces or polygons of the spheres are able to 
  182.                 be made visible.
  183.  
  184.  
  185.  
  186.     stonehenge:  demo of stonehenge with shadows, textures, etc
  187.         To Run:
  188.                 % stonehenge
  189.                 on Reality Engines, turn on texture mapping under "SPFX" menu
  190.                 Try Turning on "Scale = 1:500" under the "Time" menu - if 
  191.                 it's too jerky turn it off again.
  192.                 May want to set weather.
  193.                 The telescope option under the "SPFX" menu gives a little
  194.                 telescope which can be moved around using the mouse.
  195.                 For a non-interactive demo, select "Demo Mode" under the
  196.                 "Misc" menu.
  197.         Mouse interface:
  198.                 Make sure Demo Mode is turned off.
  199.                 LEFTMOUSE   - turn
  200.                 MIDDLEMOUSE - horizontal motion changed speed:
  201.                               left to right = forward
  202.                               right to left = backward
  203.                 RIGHTMOUSE  - stop motion
  204.         Comments:
  205.                 May have a couple of bugs.
  206.  
  207.  
  208.  
  209.     tex_cube:  small texture-mapping demo of a translucent sphere.
  210.         To Run:
  211.                 % tex_cube [name_of_square_rgb_file]
  212.                 Uses a default image if no filename is specified
  213.                 Drag with mouse to rotate
  214.  
  215.